Skip to content

Add Arch Linux / AUR (yay) packaging#33

Open
firtoz wants to merge 2 commits intowebadderall:mainfrom
firtoz:feat/yay-upstream-pr
Open

Add Arch Linux / AUR (yay) packaging#33
firtoz wants to merge 2 commits intowebadderall:mainfrom
firtoz:feat/yay-upstream-pr

Conversation

@firtoz
Copy link
Contributor

@firtoz firtoz commented Mar 15, 2026

Description

Adds packaging/arch/ with a PKGBUILD and helper files so Recordly can be installed on Arch Linux and Manjaro via the AUR (yay -S recordly-bin) or by building from this repo with makepkg -si. The package installs the prebuilt AppImage from GitHub releases and includes a desktop entry and icons.

Motivation

Arch/Manjaro users currently have to download the AppImage manually. Shipping an official PKGBUILD in the repo gives them a supported path (AUR or local build) and keeps the package definition in sync with upstream. The AUR package itself remains community-maintained; this PR only adds the packaging files to the main repo.

Type of Change

  • New Feature
  • Bug Fix
  • Refactor / Code Cleanup
  • Documentation Update
  • Other (please specify)

Related Issue(s)

None.

Publishing to the AUR (for maintainers)

Once this is merged, the recordly-bin AUR package can be published or updated in two ways:

Recommended — automated: Add a GitHub Action that runs when you cut a release (e.g. on release:published). It can bump pkgver in the PKGBUILD, regenerate .SRCINFO, and push to the AUR. You’ll need an AUR SSH key stored as a repo secret; the AUR submission guidelines and various “update AUR from GitHub Actions” guides cover the setup.

Manual: Clone the AUR package (git clone ssh://aur@aur.archlinux.org/recordly-bin.git), copy packaging/arch/PKGBUILD, .SRCINFO, recordly.desktop, and LICENSE into the clone, run makepkg --printsrcinfo > .SRCINFO if you changed the PKGBUILD, then commit and push to the master branch. See packaging/arch/README.md for the exact steps.

Note: I’ll publish and maintain the AUR package manually for now so Arch users can install via yay -S recordly-bin right away. If you’d like to take over AUR maintainership or set up the automated workflow, I’m happy to hand it over (e.g. add you as co-maintainer on the AUR package or disown it in your favour).

Screenshots / Video

image

Testing Guide

On an Arch-based system (or in a container):

git clone https://github.com/webadderall/Recordly.git && cd Recordly/packaging/arch
makepkg -si

After install, recordly should be in PATH and the app should appear in the application menu with the correct icon. Uninstall with sudo pacman -R recordly-bin.

Checklist

  • I have performed a self-review of my code.
  • I have added any necessary screenshots or videos. (N/A)
  • I have linked related issue(s) and updated the changelog if applicable. (N/A)

@webadderall webadderall added the enhancement New feature or request label Mar 16, 2026
@webadderall
Copy link
Owner

Looks good overall and I’m fine with merging this direction, especially since you’re taking manual AUR maintainership.

Before merge, can you please: (1) replace the placeholder maintainer line in PKGBUILD with your actual maintainer info, and (2) install the upstream MIT app license into /usr/share/licenses/$pkgname/ (the packaging LICENSE file in this PR is not the app’s MIT license).

Small nitpick: remove empty MimeType= and consider Icon=dev.recordly.app plus pinned sha256sums per release.

- packaging/arch: PKGBUILD for recordly-bin (prebuilt AppImage) with
  maintainer, upstream MIT license source and install to
  /usr/share/licenses/recordly-bin, pinned AppImage and LICENSE sha256sums.
- recordly.desktop: Icon=dev.recordly.app, empty MimeType= removed.
- Add PKGBUILD.from-source and recordly-local.desktop for recordly-bin-local
  (build-from-source install alongside release).
- packaging/arch/README: canonical packaging, install and AUR instructions,
  link to recordly-aur helper repo for release-triggered AUR updates.
- Main README: Arch section with yay/makepkg install and note that AUR
  publishing is handled by the recordly-aur helper repo.
- package.json: package:arch script (makepkg -si from packaging/arch).
- .gitignore: makepkg and packaging artifacts.

Made-with: Cursor
@firtoz firtoz force-pushed the feat/yay-upstream-pr branch from bb0f230 to 7939f15 Compare March 18, 2026 14:01
@coderabbitai
Copy link

coderabbitai bot commented Mar 18, 2026

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 2d0bb47f-25d2-4dbf-b261-eeaa20221e58

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
📝 Coding Plan
  • Generate coding plan for human review comments

Comment @coderabbitai help to get the list of available commands and usage tips.

Tip

You can disable poems in the walkthrough.

Disable the reviews.poem setting to disable the poems in the walkthrough.

@firtoz
Copy link
Contributor Author

firtoz commented Mar 18, 2026

@webadderall new style: i'll have a sister repo https://github.com/firtoz/recordly-aur here for aur mgmt? updated this PR to reflect that, so this repo will be the base and the aur one can pull from this one and update aur with a CRON

- package.json: added `install:linux` script for building and installing the local version of Recordly.
- README.md: updated to include instructions for local builds from source.
- packaging/arch/README.md: enhanced local build section with detailed steps for installation and usage of the local package.
@firtoz
Copy link
Contributor Author

firtoz commented Mar 18, 2026

@webadderall also added a local installation script, no more changes pending from me so ready to review 🙏

@webadderall
Copy link
Owner

Before merge, you need to (1) replace the placeholder maintainer line in PKGBUILD with your actual maintainer info, (2) install the upstream MIT app license into /usr/share/licenses/$pkgname/ (the packaging LICENSE file in this PR is not the app’s MIT license), (3) remove empty MimeType= and (4) consider Icon=dev.recordly.app plus pinned sha256sums per release.

This is from my previous comment

@webadderall
Copy link
Owner

webadderall commented Mar 19, 2026

Also, the readme documents a local source-package flow that does not exist

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Checked enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants